home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 201-220 / scopedisk215 / listcom / listcom.doc < prev    next >
Text File  |  1995-03-19  |  5KB  |  142 lines
  1. ListCom   Version 1.33    Release 10/19/1991
  2.  
  3. ListCom is copyrighted but the source can be changed and
  4. improved it if you wish. 
  5.  
  6. No warranty is expressed or implied.  Use at your own risk.  Author
  7. is not responsible for loss or damage resulting from use.
  8. (standard software disclaimer)
  9.  
  10. Phew, that's over with ...
  11.  
  12. Program:
  13. ========
  14. ListCom stands for List Comments. A Comment is a standard AmigaDOS
  15. file comment also referred to as a file note.
  16.  
  17. I wrote ListCom because all  of the DIR and LIST replacements did not
  18. give you the choice of listing by the comment.  Now granted, many
  19. normal people probably don't need this feature, but I am not one of
  20. those people.  ListCom is not intended to replace LIST or DIR.
  21.  
  22. ListCom simply lists files by comment. There are many switches, and
  23. AmigaDOS Pattern Matching for filenames and comments!  All matching
  24. is case in-sensative,  ie: joe = JoE.  If  you  wish to search with
  25. imbeded spaces, use double quotes around the argument, (ie: "arg test").
  26.  
  27. Typing ListCom  or  ListCom ?  will list the usage.
  28.  
  29.  
  30. Examples of use:
  31. ================
  32. ListCom ?               ;list template, version and usage.
  33.  
  34. ListCom                 ;list current directory, all files with comments
  35. ListCom -               ;same as above
  36. ListCom ""              ;same as above 
  37. ListCom "" ""           ;same as above 
  38.  
  39. ListCom t: #?           ;list all files even files without a comment
  40.                          as a file without a comment will match the 
  41.                          #? (all) wildcard symbol.
  42.  
  43. ListCom TERMS:DownLoads "docs for #?"  ;list files in TERMS:Downloads/
  44.                                         with comments beginning with 
  45.                                         "docs for "  (ignore quotes)
  46.  
  47. ListCom "" Utility#?    ;list current directory all files with comments
  48.                          beginning with "utility".
  49.  
  50. ListCom DH0:j#? Util#?  ;list all files in DH0: starting with "j" and
  51.                          having comments starting with "Util".
  52.  
  53. ListCom #?.lzh Util:#?  ;If executed in below directory will list only
  54.                          foo3.lzh as both requirements are matched
  55.                          only by foo3.lzh
  56.  
  57.                          foo1.arc     "Util:CLI-dir replacement"
  58.                          foo2.lzh     "Appl:DB-PD database"
  59.                         *foo3.lzh     "Util:WB2.0-Tool Menu program"
  60.  
  61.  
  62. Switches/options:
  63. =================
  64. -m = Stop at first displayed match
  65.  
  66. -f = Don't format the output.  Listcom usually outputs in the form: 
  67.      >FileName___________< >size_< >comment____________________...
  68.      With the -f option:
  69.      >filename< >size< >Comment...<
  70.      Note: multiple lists will be hard to read
  71.  
  72. -h = Don't show the heading (simular to AmigaDOS List NOHEAD option
  73.  
  74. -s = Don't show the files' size (in bytes).
  75.  
  76. -c = Don't show the comment (here for output redirection control)
  77.  
  78. -q = Quiet option, same as doing: -h -s -c
  79.  
  80. -n = Don't generate a new line character after showing entry
  81.      Suggested use is with -m option or redirected output which
  82.      doesn't want a newline character.
  83.  
  84.  
  85. Enjoy! :D
  86. John Bianchi
  87.  
  88. Send Bug Reports to:
  89. BIX: jbianchi
  90. CIS: 76256,3436
  91.  
  92.  
  93. =============================== HISTORY ================================
  94.  
  95. * 08/10/91 - created/imagined/wrote/hair-loss/loss-of-sanity....
  96.  
  97. * 08/11/91 - Made Residentable - PURE (re-entrant & Re-executable)
  98.  
  99. * 08/12/91 - Improved (kinda) and added ansi to template.
  100.  
  101. * 08/13/91 - Bug Crushed - False Read/Write Error in AmigaDOS 1.3 only.
  102.   For some reason, when you ListCom with a filename specified (not a
  103.   directory), with or without a comment, a false read/write error 
  104.   requestor would come up if the file wasn't found.  This only occurred 
  105.   in 1.3. (1.3.3 actually)
  106.  
  107. * 10/08/91 - more lost sleep as I tried to implement switches
  108.  
  109. * 10/09/91 -
  110.  
  111. * 10/17/91 -
  112.  
  113. ================================ THANKS ================================
  114.  
  115. Thanks to Browser for including C source.  Special thanks for 
  116. PatMatch.c  without it I would never had made this revision.
  117. (and probably would have had more sleep ;) zzZZZ
  118.  
  119. Thanks to Vic and Steve on CIS for their help.
  120.  
  121. Thanks Abacus for the great books
  122.  
  123. Thanks: All Amiga programmers that included source (especially the small 
  124. utility programs)  which helped me learn and write this code.
  125.  
  126. Thanks CBM!  Especially for the execute source to compile idea!  One of
  127. the worst parts of learning C on the Amiga is learning the compiler and 
  128. linker commands!  And MAKEFILES don't help 1 bit! (or even 8 bytes :)
  129. Guess one day i'll try to learn that one.  It's hard as most C source
  130. with MAKEFILES are to help manage large code segments - which also
  131. makes it VERY hard to understand.
  132.  
  133. ============================= COMMENTS ================================
  134.  
  135. I hope my source is commented enough.  As ListCom's output is handled
  136. by a call to showfileinfo(), any C programmer just learning can change
  137. the output (try including protection bits, blocks, etc and a total line
  138. for the end of the list).  Hopefully, the source will help you learn
  139. argument parsing, etc.
  140.  
  141. ============================ END OF DOCS ==============================
  142.